home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / utilitys / 499 / stext15 / stext.txt < prev    next >
Text File  |  1991-06-16  |  11KB  |  299 lines
  1.                SText - Text File Reader for the ST 
  2.          ~Shareware - Please Contribute if you use SText~
  3.                      -----------------------
  4.                     Program by Arvin Castillo 
  5.             Documentation by Noel Saw & Arvin Castillo
  6.                              3.16.91
  7.                   Program Code and Documentation
  8.                    (c)1991 NuEdge Designs, Inc. 
  9.                        All Rights Reserved
  10.                      -----------------------
  11.  
  12. This is the general documentation. Please read the UPDATE.TXT file in
  13. order to read about new features and bug fixes to SText which may not
  14. be mentioned in this manual.
  15.  
  16.  
  17.  > Legal Mumbo Jumbo and Shareware Plea
  18.    ------------------------------------
  19.  
  20. SText may be distributed freely as long as these files are included and
  21. are not modified in any way:
  22.  
  23. STEXT.PRG   : The actual program
  24. STEXT.TXT   : This documentation file
  25. STEXT.CFG   : A sample configuration file
  26. UPDATE.TXT  : update text about SText
  27. DESKTOP.INF : sample DESKTOP.INF using SText as an installed application
  28.  
  29. Please understand that I've worked long and hard in order make SText
  30. and I would like to compensated. If you find SText of any use, please
  31. make a donation of $15. I will continue to make updates to SText, and
  32. I do a lot of them, as long as YOU donate. Please make checks payable
  33. to Arvin Castillo and my address is written below.
  34.  
  35. Any bug reports, ideas, comments please contact use at: 
  36.  
  37. GEnie                : N.SAW
  38. CodeHead Quarters BBS: 1.213.461.2095 - Leave email for Noel Saw
  39. Omayver V BBS        : 1.213.732.0229 - Leave email for Noel Saw
  40. Infoline BBS         : 1.818.813.1053 - Leave email for Arvin Castillo
  41. FNET                 : Noel Saw @ node 592        
  42.  
  43. Or Write to:           Arvin Castillo
  44.                        19509 Spinningwheel Rd.
  45.                        Walnut, Ca. 91789
  46.  
  47.  
  48.  > Intro
  49.    -----
  50.     The Atari ST is great machine, but if you're like me then you're
  51. probably tired of trying to read a text file from the desktop. For one
  52. thing, if you accidentally pressed the spacebar, which moves on to the
  53. next page, the only thing you could do was quit and reload the file. That's
  54. why I created SText. SText was written to make reading text files 
  55. (ASCII) a lot easier. This program has many features and was optimized to
  56. scroll up and down very quickly using the mouse buttons. The program was
  57. written in GFA BASIC 3.0 and runs in either medium or high resolution.
  58.  
  59.  
  60.  > Using SText 
  61.    -----------
  62. SText can be executed from virtually any shell; HotWire! and NeoDesk 
  63. being prime examples. Just execute STEXT.PRG as you would any other 
  64. program. 
  65.  
  66. Next a file selector box will appear. You can click on any text file 
  67. you wish to view. If it is a legal text file, SText will begin 
  68. loading it. A message will appear indicating which text file you 
  69. loaded. Then a very fast routine called indexing will be executed.
  70. This will create at table of all the topics in the text file. 
  71.  
  72. Alternatively, you can now use SText to use view GEnie Lamp Online 
  73. Newsmagazine. The indexing will take alebit long because of the more 
  74. complex structure of TX2. SText will_not_support TX2 graphics or 
  75. fonts. However you can press F10 to jump to the differenct topics.
  76.  
  77. If you are using SText to view this file, press F10 now and you will 
  78. see an example!
  79.  
  80. As of version 1.4, you can now view Degas (uncompressed) and NeoChrome
  81. pictures from SText. You either view the pictures while reading a text
  82. file, or from the fileselector.
  83.  
  84.  
  85.  > Viewing  
  86.    -------
  87. Viewing a file with SText is easy! You have a variety of ways to 
  88. scroll around SText!
  89.  
  90. Key(s) or button
  91. ----------------
  92. Left mouse 
  93. button    : line down
  94. Right mouse
  95. button    : line up 
  96. Space bar : page down
  97. Return key: line down
  98. backspace : page up
  99. cursor up : line up
  100. cursor dwn: line down
  101. insert    : page down
  102. clr home  : page up
  103. control g : goto page #
  104. t         : goto top of text
  105. b         : goto bottom of text
  106. control t : goto top of block
  107. control b : goto bottom of block
  108.  
  109.  
  110.  > Index function and Topics
  111.    -------------------------
  112. SText supports topics, such as the ones found in STReport and Genie 
  113. Lamp/TX2. Simply put, where ever SText finds " >" , it will recognize
  114. the line as a new topic.
  115.  
  116. An index is for documents that follow the STReport or GEnie 
  117. Lamp/TX2 topic structure. This allows you to jump around within a text 
  118. file quite easily. You can access an index of topics and press an 
  119. associated key to instantly jump to that topic.
  120.  
  121. Key(s) or button
  122. ---------------
  123. n         : jump to next topic
  124. control n : previous topic
  125. f10       : list of all topics (index)
  126. alt n     : block current topic
  127.  
  128.  
  129.  > Search String
  130.    -------------
  131. If you need to find a text string in SText, it's easy as you can find 
  132. a text string really fast. 
  133.  
  134. Key(s) or button
  135. ----------------
  136. f         : start text string search from current position
  137. control f : start text string search from top of file
  138.  
  139.  
  140.  > Print and Save
  141.    --------------
  142. SText can save to disk and print a current document or block easily. 
  143. The block print or save feature is useful for saving only necessary 
  144. text areas. 
  145.  
  146. Key(s) or button
  147. ----------------
  148. p         : print current file 
  149. d         : dumps current text screen to printer
  150. control p : print text in block
  151. s         : save current file or marked block 
  152. ESC       : aborts printing
  153. e         : edit lines per page
  154. control e : toggle print quality betwen draft and NLQ(LQ)
  155. h         : toggle header on printout
  156.  
  157.  
  158.  > Mark Positions
  159.    --------------
  160. This feature allows you to mark up to four positions within a text 
  161. file. You can instantly jump to that position by pressing the 
  162. corresponding number key.
  163.  
  164. Key(s) or button
  165. ----------------
  166. f1-f4     : mark text position
  167. 1-4       : jump to corresponding funkey text position
  168.  
  169.  
  170.  > Block Functions
  171.    ---------------
  172. With a block functions you have the power of text editor with the 
  173. speed of a non-GEM program. 
  174.  
  175. Just press F5 and follow the onscreen prompts (point and click to the
  176. starting and ending of the block). You can also move around the text by
  177. position the mouse pointer to the top or bottom of the screen and pressing
  178. the right mouse button. There are also other available commands while
  179. you are in the block operation (go to top, bottom, line, marker). This
  180. makes it faster to define a rather large block (a lot faster that
  181. scrolling text). You can also append to a block by pressing F6.
  182.  
  183. Key(s) or button
  184. ----------------
  185. f5        : define a block
  186. t         : goto top
  187. b         : goto bottom
  188. g         : goto line
  189. 1 - 4     : goto defined marker
  190. spacebar  : abort block operation
  191. f6        : append to block
  192. control f5: block page # to page #
  193. f7        : resets or clears block
  194. DELETE    : delete marked block from text
  195.  
  196.  
  197.  > Launching or running an Application
  198.    -----------------------------------
  199. If you do need a text editor or word processor, SText will allow you 
  200. to run that program. It will also pass on the file path and name so 
  201. you can instantly start editing. Word Writer ST and STeno text editor 
  202. both work fine when working with SText. (Note: I never knew that this
  203. feature would be considered powerful, but it seems that the two other
  204. popular text viewers (LookIt! and TX2) have also adopted this feature.
  205. Remember, you saw it on SText first.)
  206.  
  207. There is an incompatability between SText and Abbreivator ST. 
  208. Abbreviator ST is a neat little DA that lets you expand out 
  209. abbrievated letters into there full form. The incompatability occurs 
  210. when you launch STeno. After you quit STeno, the machine bombs and 
  211. locks up the machine.
  212.  
  213. Key(s) or button
  214. ----------------
  215. l         : Launches any application; passes on the file name and 
  216.             path(similar to the Desktop's Install Application).
  217. Alt L     : Launches a default application. If there is none one can 
  218.             be assigned. 
  219. r         : removes a default application so you can assign another.
  220. control r : runs any program you want. Does not pass on file name or 
  221.             path.
  222.  
  223.  
  224.  > Quitting 
  225.    --------
  226. Key(s) or button
  227. ----------------
  228. q         : select another text file
  229. UNDO      : quick exit from SText
  230. both mouse
  231. butons    : select another text file
  232.  
  233.  
  234.  > Preferences
  235.    -----------
  236. SText allows you to manipulate your enviroment. The config file 
  237. remembers your inverse screen, status line on or off, print quality, 
  238. default application, default text path.
  239.  
  240. Key(s) or button
  241. ----------------
  242. i         : toggle inverse text on or off
  243. *         : toggles status line on or off
  244. )         : toggles page number display on or off(faster display if 
  245.             turned off)
  246. +         : increase text scrolling speed
  247. -         : decrease text scrolling speed
  248. c         : save SText configuration
  249.  
  250.  
  251.  > Misc Commands
  252.    -------------
  253. Here are some more commands to SText
  254.  
  255. Key(s) or button
  256. ----------------
  257. v         : toggle STX picture file viewing (see UPDATE.TXT)
  258. control v : view picture file (Degas uncompressed and NeoChrome)
  259. HELP      : brings up a help screen containing all available commands
  260. TAB       : brings up a status screen containing SText current
  261.             configuration
  262.  
  263.  
  264.  > SText as an installed application
  265.    ---------------------------------
  266. SText can also be an installed application. This means that whenever you
  267. double click a text file from the desktop, SText will automatically load up
  268. and the text file you clicked will also be loaded. Just load up your trusty
  269. word processor and load the file 'DESKTOP.INF' from your disk and add the
  270. following lines to the end.
  271.  
  272. #G 03 04   A:\STEXT\STEXT.PRG@ *.TXT@
  273. #G 03 04   A:\STEXT\STEXT.PRG@ *.DOC@
  274. #G 03 04   A:\STEXT\STEXT.PRG@ *.ASC@
  275. #G 03 04   A:\STEXT\STEXT.PRG@ *.1ST@
  276.  
  277.     The lines above informs GEM that whenever a file with the extenders 'TXT',
  278. 'DOC','ASC','1ST' are double clicked, to load STEXT.PRG from the folder STEXT.
  279. SText will then automatically load up the text file you chose. You can add
  280. other extenders by following the same format. Save your new 'DESKTOP.INF' and
  281. make sure you save it in ASCII format. Now, reboot your computer using the
  282. new file and SText will now be an installed application (I've included a
  283. 'DESKTOP.INF' file with the information above).
  284.  
  285.  
  286.  > Current Updates
  287.    ---------------
  288. Please read the UPDATE.TXT file in order to read about all the new
  289. features as well as bug fixes.
  290.  
  291.  
  292.  
  293.  
  294. SText - (C)1991 ~NuEdge Designs -Created by Arvin Castillo
  295. Atari, Atari ST, NeoChrome are the registered trademarks of Atari Corp.
  296. GEnie is a trademark of General Electric Corp. 
  297.  
  298.  
  299. lllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllllll